home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / program / mdf145.zip / MDF_ITA.DOC < prev    next >
Text File  |  1995-08-21  |  16KB  |  407 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                   MDIFF  -  MPATCH
  12.                                     Release  1.45
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.           Un software semplice ma completo per produrre e applicare patch a
  24.           programmi e file di dati per Dos, OS/2, Windows 95 e Windows NT.
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                              Manuale in lingua italiana.
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.                (C) 1995/96 Maurizio Giunti - Tutti i diritti riservati
  47.  
  48.  
  49.  
  50.  
  51.  
  52.      1.SOMMARIO
  53.  
  54.  
  55.      1.SOMMARIO                                                               2
  56.  
  57.  
  58.      2.DIRITTI                                                                3
  59.  
  60.  
  61.      3.GARANZIE                                                               3
  62.  
  63.  
  64.      4.PERCHE'                                                                3
  65.  
  66.  
  67.      5.A COSA SERVE                                                           3
  68.  
  69.  
  70.      6.DOS, OS/2, WINDOWS 95 E WINDOWS NT                                     4
  71.  
  72.  
  73.      7.LIMITI                                                                 4
  74.  
  75.  
  76.      8.MDIFF - MDIFF2 - MDIFFW                                                4
  77.  
  78.  
  79.      9.MPATCH - MPATCH2 - MPATCHW                                             5
  80.  
  81.  
  82.      10.MDF2EXE - MDF2EXE2 - MDF2EXEW                                         5
  83.  
  84.  
  85.      11.ALCUNI CONSIGLI                                                       6
  86.  
  87.  
  88.      12.LIBRERIE PER APPLICARE PATCH                                          6
  89.  
  90.  
  91.      13.COME REGISTRARSI                                                      6
  92.  
  93.  
  94.      14.RINGRAZIAMENTI                                                        7
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.                                                                               2
  107.  
  108.  
  109.  
  110.  
  111.  
  112.      2.DIRITTI
  113.      Questo  software   appartiene alla categoria   dei  programmi  Shareware:
  114.      chiunque lo puo'  liberamente copiare ed   utilizzare per  un periodo  di
  115.      prova di    15 giorni.    Dopo   tale   periodo,  l'utente  che  desideri
  116.      continuare ad    utilizzarlo e'  tenuto  a registrare  la  propria  copia
  117.      inviando la quota di registrazione all'autore, Maurizio Giunti.
  118.      Gli utenti che pagano la quota  di registrazione riceveranno una  "chiave
  119.      di registrazione" personale e non cedibile, che rendera'  "registrata" la
  120.      propria copia del programma.
  121.      Chiunque puo' ridistribuire questo software a condizione che non richieda
  122.      alcuna somma di denaro in cambio, fatta  eccezione per le spese  di copia
  123.      e/o di spedizione che, pero', devono essere adeguatamente documentate.
  124.      Altra condizione per la libera distribuzione e' che venga  sempre fornito
  125.      per intero il contenuto del pacchetto di  distribuzione  originale, senza
  126.      alcuna modifica ai programmi e/o alla documentazione.
  127.      Un'unica  eccezione:  il   programma  MPATCH   puo'  essere   liberamente
  128.      ridistribuito insieme ad uno o piu'  files *.MDF  prodotti con una  copia
  129.      REGISTRATA di MDIFF.
  130.  
  131.  
  132.  
  133.        GARANZIE     3.
  134.      L'unica garanzia  fornita con  questo software  e' che  occupa spazio  su
  135.      disco. Non posso  assolutamente garantire che   funzioni perfettamente  o
  136.      rappresenti la soluzione di ogni vostro problema. Sono inoltre sicuro che
  137.      non e' un virus e   non contiene (a meno che non  sia stato infettato   o
  138.      modificato  dopo  la  compilazione)  Trojan-Horses,  Back-Doors  o  altre
  139.      diavolerie simili.  In ogni  caso l'autore  declina ogni  responsabilita'
  140.      diretta o indiretta, per  eventuali danni   morali o materiali  derivanti
  141.      dal suo uso.
  142.  
  143.  
  144.  
  145.      4.PERCHE'
  146.      Qualche tempo  fa dovevo  rilasciare una  versione aggiornata  di un  mio
  147.      programma: il pacchetto compresso "pesava"  piu' di 200 Kbyte,  e sarebbe
  148.      stato sicuramente  piu'  conveniente  per  tutti  aggiornare  il  vecchio
  149.      eseguibile tramite una patch.   Mi misi in caccia  di un software che  mi
  150.      permettesse di creare e distribuire patch  dei miei programmi  per Dos  e
  151.      OS/2: per Dos ne ho trovati alcuni (ma non mi hanno soddisfatto  per vari
  152.      motivi),  per  OS/2  neanche  uno!  Ho  quindi  deciso  di   farmene  uno
  153.      e....eccolo qui ! 8-)
  154.  
  155.  
  156.  
  157.        A COSA SERVE     5.
  158.      MDIFF crea un file binario  di differenza tra due  file. Con MPATCH e  il
  159.      vecchio file  si  puo' ricreare  il  nuovo file    partendo dal  file  di
  160.      differenza. Cosa c'e' di buono in tutto cio'? Semplice: supponendo che il
  161.      file di differenza sia   piu' breve del  nuovo file, e' piu'  conveniente
  162.      distribuire solo  quello  invece di  tutto  il file,  soprattutto  se  la
  163.      distribuzione avviene via modem.
  164.  
  165.  
  166.                                                                               3
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.      6.DOS, OS/2, WINDOWS 95 E WINDOWS NT
  174.      MDIFF e  MPATCH  per  Dos,  OS/2  e  Windows  sono  ottenuti  tramite  la
  175.      compilazione dei  medesimi sorgenti,  quindi non  c'e' alcuna  differenza
  176.      nella funzione e nell'uso di tali  programmi sui vari sistemi  operativi.
  177.      Inoltre i  files  *.MDF  prodotti  con  MDIFF per    Dos  possono  essere
  178.      utilizzati con MPATCH per OS/2 o Windows e viceversa.
  179.  
  180.  
  181.  
  182.        LIMITI     7.
  183.      MDIFF non puo' trattare files piu' ampi di 16 Megabyte. Questo e' l'unico
  184.      limite fisico generale di MDIFF.
  185.      Inoltre MDIFF per OS/2, essendo ottenuto tramite una compilazione diretta
  186.      dei sorgenti di MDIFF per Dos, non e' in grado di trattare  gli attributi
  187.      estesi, quindi si limitera' ad ignorarli.
  188.  
  189.  
  190.  
  191.      8.MDIFF - MDIFF2 - MDIFFW
  192.      Il programma MDIFF si occupa di comparare due files e di immagazzinare le
  193.      differenze tra di essi in un terzo file  che, generalmente, e' molto piu'
  194.      compatto. Vediamo come si usa:
  195.  
  196.         MDIFF [-C<c>] [-R<r>] [-F<f>] [-S] [-Z] [-P<pwd>] <OldFile> <NewFile>
  197.                                      [<MDFfile>]
  198.  
  199.      <OldFile> ovviamente e'  il nome  della versione precedente  del file  da
  200.      comparare, mentre  <NewFile>  e' il  nome  della   versione  attuale.  Se
  201.      necessario si puo' specificare il nome  del file di differenza da  creare
  202.      <MDFfile>, altrimenti   MDIFF  crea un  file  che ha  lo stesso  nome  di
  203.      <NewFile> ma estensione ".MDF".  Per cercare le  parti simili nei  files,
  204.      MDIFF si serve di una stringa base di lunghezza predefinita  detta chunk.
  205.      La lunghezza del chunk e' per default di  16 byte ma puo' essere cambiata
  206.      (in un range  4-256) con  lo switch  -C seguito  dalla lunghezza  voluta.
  207.      Quando  MDIFF perde il sincronismo tra i due files che  sta confrontando,
  208.      cerca di ritrovarlo scandendo il vecchio file alla  ricerca del chunk che
  209.      sta elaborando. Tale ricerca viene effettuata, in un  intorno dell'ultimo
  210.      chunk trovato, nel range definito dallo switch -R. Per default tale range
  211.      e' di 8 blocchi di 512 byte, ma puo' variare tra 1 e 16. Se tale  ricerca
  212.      fallisce MDIFF cerca di forzare il sincronismo cercando in un raggio piu'
  213.      ampio di quello definito solitamente ampio 1/16 della lunghezza del file.
  214.      Questa seconda  ricerca puo'  essere disabilitata  o  il suo  range  puo'
  215.      essere cambiato tramite lo  switch -F. Specificando lo  switch  -S,  alla
  216.      fine dell'operazione, MDIFF  fornira' alcuni dati sulla  composizione del
  217.      file di differenza.
  218.      E' inoltre  possibile,  tramite  lo  switch  -Z,  inserire  nel  file  di
  219.      differenza un breve commento (al massimo 2 Kbyte), che sara' visualizzato
  220.      durante l'applicazione della patch da parte di MPATCH. Il  commento viene
  221.      prelevato direttamente  dallo  standard  input e  quindi  puo'  essere  o
  222.      digitato o prelevato da un file tramite l'apposito comando di redirezione
  223.      "<".
  224.      Tramite lo  switch  -P si  puo'  proteggere  la patch  con  una  password
  225.      (<pwd>): chi non conosce tale password non potra' applicare la patch.
  226.                                                                               4
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.      9.MPATCH - MPATCH2 - MPATCHW
  235.      MDIFF sarebbe  un  programma inutile  se  non esistesse  MPATCH.  Infatti
  236.      MPATCH si occupa,  dati <OldFile>  e  <MDFfile>,  di ricreare  <NewFile>.
  237.      Vediamo come si usa:
  238.  
  239.                  MPATCH [-P<pwd>] <MDFfile> [<OldFile> [<NewFile>]]
  240.  
  241.      L'unico parametro necessario e' il nome del file di  differenza <MDFfile>
  242.      perche' esso  contiene i  nomi degli  altri due   file,  ma e'  possibile
  243.      modificare tale impostazione   semplicemente specificando  i nomi  voluti
  244.      nell'esatto  ordine.  MPATCH  ha  il  solo  switch  -P  che  permette  di
  245.      specificare una eventuale password necessaria per applicare la patch.
  246.      In  caso  di  errore  MPATCH  ritorna  un  errorlevel  che   deve  essere
  247.      interpretato secondo la seguente tabella:
  248.         Codice   Descrizione
  249.                  "OK!"          0
  250.                  "Out of memory !"          1
  251.                  "Can't open MDF file !"          2
  252.                  "Invalid MDF file !"          3
  253.                  "MDF file version mismatch !"          4
  254.                  "UNREGISTERED !"          5
  255.                  "Bad or incorrect OLD file !"          6
  256.           7      "Can't open OLD file !"
  257.                  "Can't create NEW file !"          8
  258.                  "General failure: NEW file corrupted !"          9
  259.                  "OLD and NEW can't be the same file !"          10
  260.                  "NEW file was already patched ! "          11
  261.                  "Bad password !"          12
  262.  
  263.  
  264.  
  265.         MDF2EXE - MDF2EXE2 - MDF2EXEW     10.
  266.      MDF2EXE si occupa di trasformare un file di patch *.MDF creato  con MDIFF
  267.      in un file ESEGUIBILE autoinstallante per Dos (MDF2EXE),  OS/2 (MDF2EXE2)
  268.      o Windows 95/Windows NT (MDF2EXEW).
  269.      Il  file  cosi'  creato  conterra'  al   suo  interno  il  programma   di
  270.      installazione e un certo numero di file di patch (al massimo 127).
  271.      La sintassi per creare una patch autoinstallante e':
  272.  
  273.            MDF2EXE <mdf_file 1> [<mdf_file 2>....<mdf_file n>] <exe_file>
  274.  
  275.      I vari  <mdf_file x>  possono contenere  anche wildcard,  in questo  caso
  276.      MDF2EXE crchera' automaticamente i files da inserire.
  277.      Il file eseguibile creato (che DEVE avere estensione .EXE)  potra' essere
  278.      avviato  senza  alcun  parametro  sulla  linea  di  comando  e  cerchera'
  279.      automaticamente  i  file   da  aggiornare.   Opzionalmente  puo'   essere
  280.      utilizzato lo switch -P per specificare una password oppure gli switch -V
  281.      o -L per visualizzare la lista delle patch contenute nel file.
  282.      Un'unica nota: non comprimete le patch autoinstallanti con  pklite, lzexe
  283.      o altri software simili, altrimenti esse cesseranno di funzionare.
  284.  
  285.  
  286.                                                                               5
  287.  
  288.  
  289.  
  290.  
  291.      11.ALCUNI CONSIGLI
  292.      Il metodo ottimale per costruire un file di differenza sarebbe  quello di
  293.      ricercare per tutto  il vecchio file  i chunks   che compongono il  nuovo
  294.      file;  ovviamente  tale  metodo  sarebbe  di  una  lentezza  esasperante.
  295.      L'algoritmo su  cui  e'   basato  MDIFF rappresenta  un  compromesso  tra
  296.      risultato e velocita'  di esecuzione,  per questo  e' talvolta  opportuno
  297.      regolare i  parametri  di funzionamento  di  MDIFF tramite  gli  appositi
  298.      switch. Vediamo come comportarsi in  alcune situazioni tipiche:
  299.        File con pochissime modifiche: e'  opportuno utilizzare un chunk  molto     1. 
  300.        ampio (32,  64  o piu')  in  modo da    ridurre il  piu'  possibile  le
  301.        dimensioni del file di differenza, soprattutto se si sta' lavorando con
  302.        files di testo o con archivi.
  303.      2.        File di testo: di solito un chunk di dimensione 32 e' il piu' indicato,
  304.        e' opportuno provare  a diminuire  o togliere il   sincronismo  forzato
  305.        tramite lo switch -F.
  306.        File eseguibili molto  ampi: spesso   si  ottengono risultati  migliori     3. 
  307.        allargando il range di ricerca del  sincronismo  tramite lo switch -R.
  308.      Un ultimo consiglio:  non attendetevi miracoli  da MDIFF. Se  i due  file
  309.      confrontati sono molto dissimili il file di patch risultera' molto ampio.
  310.      In questi casi c'e' ben poco  da fare, bisogna rassegnarsi a  distribuire
  311.      il nuovo file  interamente. MDIFF e'  realmente utile solo  se il  numero
  312.      delle modifiche apportate ai file non e' troppo grande.
  313.  
  314.  
  315.  
  316.         LIBRERIE PER APPLICARE PATCH     12.
  317.      Fino alla  release 1.40  nel pacchetto  di distribuzione  di MDIFF  erano
  318.      contenute anche  alcune  librerie per  Dos,  Windows e  OS/2,  utili  per
  319.      realizzare propri programmi per applicare patch.
  320.      A causa dello  scarso feedback  dell'utenza e della  diminuzione del  mio
  321.      tempo libero ho deciso di non continuare a distribuire tali librerie.
  322.      In ogni  caso  cerchero' di  portarne  avanti lo  sviluppo  trascurandone
  323.      invece i manuali, per cui se  qualcuno fosse DAVVERO interessato ad  esse
  324.      non esiti a contattarmi.
  325.  
  326.  
  327.  
  328.      13.COME REGISTRARSI
  329.      Il costo della  chiave di  registrazione individuale, valida  sia per  la
  330.      versione Dos che  per quelle OS/2  e Windows, per  tutte le release  fino
  331.      alla 1.99 compresa, e' di 25.000 lire italiane (circa 16 U.S.$)  spese di
  332.      spedizione comprese. Il  codice di registrazione  sara' spedito   tramite
  333.      normale lettera, oppure, a richiesta, via E-mail.
  334.      La  registrazione  puo'  essere  effettuata  in  qualsiasi  modo,  ma  e'
  335.      consigliabile  l'utilizzo di  vaglia  postale  in Italia o  International
  336.      Postal Check in Lire Italiane dall'estero, pagabile all'ufficio   postale
  337.      di "FIRENZE" ed intestato al  seguente nominativo:
  338.  
  339.                                    Maurizio Giunti
  340.                                 Via G.B. Foggini, 24
  341.                                  50142 Firenze (FI)
  342.                                         ITALY
  343.  
  344.      Per i residenti  in Europa  puo' essere  piu' conveniente  l'invio di  un
  345.      Eurocheque in Lire Italiane.
  346.                                                                               6
  347.  
  348.  
  349.  
  350.  
  351.      In ogni caso ricordate di indicare  il nome del programma da  registrare,
  352.      il vostro nome, cognome, indirizzo e indirizzo e-mail (se necessario). Se
  353.      siete utenti  Fidonet  o  Internet e  necessitate  di  delucidazioni  non
  354.      esitate a spedirmi un e-mail ai seguenti indirizzi:
  355.  
  356.                                 Fidonet: 2:332/102.3
  357.  
  358.                              Internet: giunti@abeline.it
  359.  
  360.  
  361.  
  362.      14.RINGRAZIAMENTI
  363.      Vorrei brevemente  ringraziare  gli  amici che  mi  hanno  aiutato  nello
  364.      sviluppo di questo software  e della  documentazione  allegata, o che  si
  365.      sono coraggiosamente offerti come beta-testers. In ordine alfabetico:
  366.  
  367.  
  368.                                    Andrea Baitelli
  369.  
  370.                                     Silvia Borri
  371.  
  372.                                     Filippo Dini
  373.  
  374.                                  Fabrizio Fioravanti
  375.  
  376.                                  Cristiano Guidoccio
  377.  
  378.                                 Giovanni Lopes Pegna
  379.  
  380.                                   Marco Maccaferri
  381.  
  382.                                   Marco Menichelli
  383.  
  384.                                    Giuseppe Scarpi
  385.  
  386.                                    Toni Tatafiore
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.                                                                               7
  407.